/ InfoMagic Internet Tools 1993 July / Internet Tools.iso / RockRidge / mail / pp / pp-6.0 / doc / manual / volume2 / channels.tex / node6_ct.html

< prev

next >

MacOS 8.1

Win98

DOS

browse contents

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 3c 21 44 4f 43 54 59 50 | 45 20 48 54 4d 4c 20 50 |<!DOCTYP|E HTML P|
|00000010| 55 42 4c 49 43 20 22 2d | 2f 2f 57 33 43 2f 2f 44 |UBLIC "-|//W3C//D|
|00000020| 54 44 20 48 54 4d 4c 20 | 33 2e 32 20 46 69 6e 61 |TD HTML |3.2 Fina|
|00000030| 6c 2f 2f 65 6e 22 3e 0a | 0a 3c 21 2d 2d 43 6f 6e |l//en">.|.<!--Con|
|00000040| 76 65 72 74 65 64 20 77 | 69 74 68 20 4c 61 54 65 |verted w|ith LaTe|
|00000050| 58 32 48 54 4d 4c 20 32 | 30 32 32 20 28 52 65 6c |X2HTML 2|022 (Rel|
|00000060| 65 61 73 65 64 20 4a 61 | 6e 75 61 72 79 20 31 2c |eased Ja|nuary 1,|
|00000070| 20 32 30 32 32 29 20 2d | 2d 3e 0a 3c 48 54 4d 4c | 2022) -|->.<HTML|
|00000080| 20 6c 61 6e 67 3d 22 65 | 6e 22 3e 0a 3c 48 45 41 | lang="e|n">.<HEA|
|00000090| 44 3e 0a 3c 54 49 54 4c | 45 3e 43 6f 6e 74 65 6e |D>.<TITL|E>Conten|
|000000a0| 74 73 20 6f 66 20 51 75 | 65 75 65 20 4d 61 6e 61 |ts of Qu|eue Mana|
|000000b0| 67 65 72 20 49 6e 74 65 | 72 61 63 74 69 6f 6e 3c |ger Inte|raction<|
|000000c0| 2f 54 49 54 4c 45 3e 0a | 0a 3c 4d 45 54 41 20 48 |/TITLE>.|.<META H|
|000000d0| 54 54 50 2d 45 51 55 49 | 56 3d 22 43 6f 6e 74 65 |TTP-EQUI|V="Conte|
|000000e0| 6e 74 2d 54 79 70 65 22 | 20 43 4f 4e 54 45 4e 54 |nt-Type"| CONTENT|
|000000f0| 3d 22 74 65 78 74 2f 68 | 74 6d 6c 3b 20 63 68 61 |="text/h|tml; cha|
|00000100| 72 73 65 74 3d 75 74 66 | 2d 38 22 3e 0a 3c 4d 45 |rset=utf|-8">.<ME|
|00000110| 54 41 20 4e 41 4d 45 3d | 22 76 69 65 77 70 6f 72 |TA NAME=|"viewpor|
|00000120| 74 22 20 43 4f 4e 54 45 | 4e 54 3d 22 77 69 64 74 |t" CONTE|NT="widt|
|00000130| 68 3d 64 65 76 69 63 65 | 2d 77 69 64 74 68 2c 20 |h=device|-width, |
|00000140| 69 6e 69 74 69 61 6c 2d | 73 63 61 6c 65 3d 31 2e |initial-|scale=1.|
|00000150| 30 22 3e 0a 3c 4d 45 54 | 41 20 4e 41 4d 45 3d 22 |0">.<MET|A NAME="|
|00000160| 47 65 6e 65 72 61 74 6f | 72 22 20 43 4f 4e 54 45 |Generato|r" CONTE|
|00000170| 4e 54 3d 22 4c 61 54 65 | 58 32 48 54 4d 4c 20 76 |NT="LaTe|X2HTML v|
|00000180| 32 30 32 32 22 3e 0a 0a | 3c 4c 49 4e 4b 20 52 45 |2022">..|<LINK RE|
|00000190| 4c 3d 22 53 54 59 4c 45 | 53 48 45 45 54 22 20 48 |L="STYLE|SHEET" H|
|000001a0| 52 45 46 3d 22 63 68 61 | 6e 6e 65 6c 73 2e 63 73 |REF="cha|nnels.cs|
|000001b0| 73 22 3e 0a 0a 3c 4c 49 | 4e 4b 20 52 45 4c 3d 22 |s">..<LI|NK REL="|
|000001c0| 6e 65 78 74 22 20 48 52 | 45 46 3d 22 6e 6f 64 65 |next" HR|EF="node|
|000001d0| 37 5f 6d 6e 2e 68 74 6d | 6c 22 3e 0a 3c 4c 49 4e |7_mn.htm|l">.<LIN|
|000001e0| 4b 20 52 45 4c 3d 22 70 | 72 65 76 69 6f 75 73 22 |K REL="p|revious"|
|000001f0| 20 48 52 45 46 3d 22 6e | 6f 64 65 35 5f 6d 6e 2e | HREF="n|ode5_mn.|
|00000200| 68 74 6d 6c 22 3e 0a 3c | 4c 49 4e 4b 20 52 45 4c |html">.<|LINK REL|
|00000210| 3d 22 75 70 22 20 48 52 | 45 46 3d 22 6e 6f 64 65 |="up" HR|EF="node|
|00000220| 35 5f 6d 6e 2e 68 74 6d | 6c 22 3e 0a 3c 4c 49 4e |5_mn.htm|l">.<LIN|
|00000230| 4b 20 52 45 4c 3d 22 6e | 65 78 74 22 20 48 52 45 |K REL="n|ext" HRE|
|00000240| 46 3d 22 6e 6f 64 65 37 | 5f 6d 6e 2e 68 74 6d 6c |F="node7|_mn.html|
|00000250| 22 3e 0a 3c 2f 48 45 41 | 44 3e 0a 20 0a 3c 42 4f |">.</HEA|D>. .<BO|
|00000260| 44 59 20 62 67 63 6f 6c | 6f 72 3d 22 23 66 66 66 |DY bgcol|or="#fff|
|00000270| 66 66 66 22 20 74 65 78 | 74 3d 22 23 30 30 30 30 |fff" tex|t="#0000|
|00000280| 30 30 22 20 6c 69 6e 6b | 3d 22 23 39 39 34 34 45 |00" link|="#9944E|
|00000290| 45 22 20 76 6c 69 6e 6b | 3d 22 23 30 30 30 30 66 |E" vlink|="#0000f|
|000002a0| 66 22 20 61 6c 69 6e 6b | 3d 22 23 30 30 66 66 30 |f" alink|="#00ff0|
|000002b0| 30 22 3e 0a 0a 3c 48 33 | 3e 3c 41 20 49 44 3d 22 |0">..<H3|><A ID="|
|000002c0| 53 45 43 54 49 4f 4e 30 | 30 31 32 32 31 30 30 30 |SECTION0|01221000|
|000002d0| 30 30 30 30 30 30 30 30 | 30 30 30 22 3e 0a 51 75 |00000000|000">.Qu|
|000002e0| 65 75 65 20 4d 61 6e 61 | 67 65 72 20 49 6e 74 65 |eue Mana|ger Inte|
|000002f0| 72 61 63 74 69 6f 6e 3c | 2f 41 3e 0a 3c 2f 48 33 |raction<|/A>.</H3|
|00000300| 3e 0a 0a 3c 50 3e 0a 54 | 68 65 20 71 75 65 75 65 |>..<P>.T|he queue|
|00000310| 20 6d 61 6e 61 67 65 72 | 20 69 6e 74 65 72 61 63 | manager| interac|
|00000320| 74 69 6f 6e 20 69 73 20 | 6e 6f 72 6d 61 6c 6c 79 |tion is |normally|
|00000330| 20 68 61 6e 64 6c 65 64 | 20 62 79 20 61 20 73 69 | handled| by a si|
|00000340| 6e 67 6c 65 0a 70 72 6f | 63 65 64 75 72 65 2c 20 |ngle.pro|cedure, |
|00000350| 0a 3c 42 52 3e 3c 63 6f | 64 65 3e 63 68 61 6e 6e |.<BR><co|de>chann|
|00000360| 65 6c 5f 63 6f 6e 74 72 | 6f 6c 3c 2f 63 6f 64 65 |el_contr|ol</code|
|00000370| 3e 2c 20 77 68 69 63 68 | 20 6d 61 6e 61 67 65 73 |>, which| manages|
|00000380| 20 74 68 65 20 73 65 73 | 73 69 6f 6e 20 77 69 74 | the ses|sion wit|
|00000390| 68 20 74 68 65 0a 51 4d | 47 52 20 61 6e 64 20 63 |h the.QM|GR and c|
|000003a0| 61 6c 6c 73 20 74 68 65 | 20 61 70 70 72 6f 70 72 |alls the| appropr|
|000003b0| 69 61 74 65 20 72 6f 75 | 74 69 6e 65 73 20 6f 6e |iate rou|tines on|
|000003c0| 20 72 65 63 65 69 70 74 | 20 6f 66 20 52 4f 53 20 | receipt| of ROS |
|000003d0| 6f 70 65 72 61 74 69 6f | 6e 73 2e 0a 0a 3c 50 3e |operatio|ns...<P>|
|000003e0| 0a 3c 42 4c 4f 43 4b 51 | 55 4f 54 45 3e 0a 3c 41 |.<BLOCKQ|UOTE>.<A|
|000003f0| 20 49 44 3d 22 32 37 22 | 3e 3c 2f 41 3e 3c 2f 42 | ID="27"|></A></B|
|00000400| 4c 4f 43 4b 51 55 4f 54 | 45 3e 3c 50 52 45 3e 0a |LOCKQUOT|E><PRE>.|
|00000410| 69 6e 74 20 63 68 61 6e | 6e 65 6c 5f 63 6f 6e 74 |int chan|nel_cont|
|00000420| 72 6f 6c 20 28 61 72 67 | 63 2c 20 61 72 67 76 2c |rol (arg|c, argv,|
|00000430| 20 69 6e 69 74 66 6e 78 | 2c 20 0a 20 20 20 20 20 | initfnx|, .     |
|00000440| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00000450| 70 72 6f 63 66 6e 78 2c | 20 65 6e 64 66 6e 78 29 |procfnx,| endfnx)|
|00000460| 0a 69 6e 74 20 20 20 20 | 61 72 67 63 3b 0a 63 68 |.int    |argc;.ch|
|00000470| 61 72 20 20 20 2a 2a 61 | 72 67 76 3b 0a 49 46 50 |ar   **a|rgv;.IFP|
|00000480| 20 20 20 20 69 6e 69 74 | 66 6e 78 3b 0a 73 74 72 |    init|fnx;.str|
|00000490| 75 63 74 20 74 79 70 65 | 5f 51 6d 67 72 5f 44 65 |uct type|_Qmgr_De|
|000004a0| 6c 69 76 65 72 79 53 74 | 61 74 75 73 20 20 20 2a |liverySt|atus   *|
|000004b0| 28 2a 70 72 6f 63 66 6e | 78 29 28 29 3b 0a 49 46 |(*procfn|x)();.IF|
|000004c0| 50 20 20 20 20 65 6e 64 | 66 6e 78 3b 0a 3c 2f 50 |P    end|fnx;.</P|
|000004d0| 52 45 3e 0a 0a 3c 50 3e | 0a 54 68 65 20 61 72 67 |RE>..<P>|.The arg|
|000004e0| 75 6d 65 6e 74 73 20 61 | 72 65 20 61 73 20 66 6f |uments a|re as fo|
|000004f0| 6c 6c 6f 77 73 3a 0a 3c | 42 52 3e 0a 3c 49 4d 47 |llows:.<|BR>.<IMG|
|00000500| 0a 20 20 53 54 59 4c 45 | 3d 22 22 20 53 52 43 3d |.  STYLE|="" SRC=|
|00000510| 22 69 6d 67 31 2e 70 6e | 67 22 0a 20 41 4c 54 3d |"img1.pn|g". ALT=|
|00000520| 22 5c 62 65 67 69 6e 7b | 64 65 73 63 72 69 62 65 |"\begin{|describe|
|00000530| 7d 0a 5c 69 74 65 6d 5b | 5c 76 65 72 62 5c 76 65 |}.\item[|\verb\ve|
|00000540| 72 74 20 61 72 67 63 5c | 76 65 72 74 2f 5c 76 65 |rt argc\|vert/\ve|
|00000550| 72 62 5c 76 65 72 74 20 | 61 72 67 76 5c 76 65 72 |rb\vert |argv\ver|
|00000560| 74 3a 5d 20 54 68 65 20 | 61 72 67 75 6d 65 6e 74 |t:] The |argument|
|00000570| 20 2e 2e 2e 0a 2e 2e 2e | 62 5c 76 65 72 74 20 4e | .......|b\vert N|
|00000580| 55 4c 4c 49 46 50 5c 76 | 65 72 74 20 6d 61 79 20 |ULLIFP\v|ert may |
|00000590| 62 65 20 75 73 65 64 20 | 69 66 20 74 68 69 73 20 |be used |if this |
|000005a0| 66 75 6e 63 74 69 6f 6e | 0a 69 73 20 6e 6f 74 20 |function|.is not |
|000005b0| 72 65 71 75 69 72 65 64 | 2e 0a 5c 65 6e 64 7b 64 |required|..\end{d|
|000005c0| 65 73 63 72 69 62 65 7d | 22 3e 0a 3c 42 52 3e 0a |escribe}|">.<BR>.|
|000005d0| 54 68 65 20 3c 63 6f 64 | 65 3e 63 68 61 6e 6e 65 |The <cod|e>channe|
|000005e0| 6c 5f 63 6f 6e 74 72 6f | 6c 3c 2f 63 6f 64 65 3e |l_contro|l</code>|
|000005f0| 20 66 75 6e 63 74 69 6f | 6e 20 69 6e 76 6f 6b 65 | functio|n invoke|
|00000600| 73 20 69 74 73 20 6f 77 | 6e 20 65 72 72 6f 72 20 |s its ow|n error |
|00000610| 68 61 6e 64 6c 65 72 73 | 0a 61 6e 64 20 64 6f 65 |handlers|.and doe|
|00000620| 73 20 6e 6f 74 20 6e 6f | 72 6d 61 6c 6c 79 20 72 |s not no|rmally r|
|00000630| 65 74 75 72 6e 2e 0a 0a | 3c 50 3e 0a 54 68 65 20 |eturn...|<P>.The |
|00000640| 74 77 6f 20 66 75 6e 63 | 74 69 6f 6e 73 20 3c 63 |two func|tions <c|
|00000650| 6f 64 65 3e 69 6e 69 74 | 66 6e 78 3c 2f 63 6f 64 |ode>init|fnx</cod|
|00000660| 65 3e 20 61 6e 64 20 3c | 63 6f 64 65 3e 70 72 6f |e> and <|code>pro|
|00000670| 63 66 6e 78 3c 2f 63 6f | 64 65 3e 20 73 68 6f 77 |cfnx</co|de> show|
|00000680| 6e 20 61 62 6f 76 65 20 | 61 72 65 20 74 68 65 20 |n above |are the |
|00000690| 6b 65 79 20 74 6f 20 74 | 68 65 20 63 68 61 6e 6e |key to t|he chann|
|000006a0| 65 6c 73 0a 6f 70 65 72 | 61 74 69 6f 6e 2e 20 54 |els.oper|ation. T|
|000006b0| 68 65 20 69 6e 69 74 69 | 61 6c 69 73 61 74 69 6f |he initi|alisatio|
|000006c0| 6e 20 66 75 6e 63 74 69 | 6f 6e 20 73 68 6f 75 6c |n functi|on shoul|
|000006d0| 64 20 62 65 20 64 65 66 | 69 6e 65 64 20 69 6e 20 |d be def|ined in |
|000006e0| 74 68 65 0a 66 6f 6c 6c | 6f 77 69 6e 67 20 77 61 |the.foll|owing wa|
|000006f0| 79 3a 3c 50 52 45 3e 0a | 69 6e 74 20 20 20 69 6e |y:<PRE>.|int   in|
|00000700| 69 74 66 6e 78 20 28 61 | 72 67 29 0a 73 74 72 75 |itfnx (a|rg).stru|
|00000710| 63 74 20 74 79 70 65 5f | 51 6d 67 72 5f 43 68 61 |ct type_|Qmgr_Cha|
|00000720| 6e 6e 65 6c 20 2a 61 72 | 67 3b 0a 3c 2f 50 52 45 |nnel *ar|g;.</PRE|
|00000730| 3e 0a 0a 3c 50 3e 0a 54 | 68 65 20 66 75 6e 63 74 |>..<P>.T|he funct|
|00000740| 69 6f 6e 20 73 68 6f 75 | 6c 64 20 74 68 65 6e 20 |ion shou|ld then |
|00000750| 64 65 63 69 64 65 20 77 | 68 65 74 68 65 72 20 74 |decide w|hether t|
|00000760| 68 65 20 67 69 76 65 6e | 20 63 68 61 6e 6e 65 6c |he given| channel|
|00000770| 20 61 72 67 75 6d 65 6e | 74 20 69 73 0a 73 65 6e | argumen|t is.sen|
|00000780| 73 69 62 6c 65 20 66 6f | 72 20 74 68 69 73 20 63 |sible fo|r this c|
|00000790| 68 61 6e 6e 65 6c 20 61 | 6e 64 20 72 65 74 75 72 |hannel a|nd retur|
|000007a0| 6e 20 6f 6e 65 20 6f 66 | 20 74 68 65 20 63 6f 6e |n one of| the con|
|000007b0| 73 74 61 6e 74 73 20 3c | 63 6f 64 65 3e 4f 4b 3c |stants <|code>OK<|
|000007c0| 2f 63 6f 64 65 3e 20 6f | 72 0a 3c 63 6f 64 65 3e |/code> o|r.<code>|
|000007d0| 4e 4f 54 4f 4b 3c 2f 63 | 6f 64 65 3e 2e 20 54 68 |NOTOK</c|ode>. Th|
|000007e0| 69 73 20 66 75 6e 63 74 | 69 6f 6e 20 69 73 20 6e |is funct|ion is n|
|000007f0| 6f 72 6d 61 6c 6c 79 20 | 6f 6e 6c 79 20 63 61 6c |ormally |only cal|
|00000800| 6c 65 64 20 6f 6e 63 65 | 20 62 79 20 74 68 65 20 |led once| by the |
|00000810| 51 4d 47 52 2c 0a 62 75 | 74 20 69 6e 20 63 61 73 |QMGR,.bu|t in cas|
|00000820| 65 73 20 77 68 65 72 65 | 20 74 68 65 20 73 61 6d |es where| the sam|
|00000830| 65 20 70 72 6f 67 72 61 | 6d 20 63 61 6e 20 72 75 |e progra|m can ru|
|00000840| 6e 20 61 73 20 61 20 6e | 75 6d 62 65 72 20 6f 66 |n as a n|umber of|
|00000850| 20 63 68 61 6e 6e 65 6c | 73 20 69 74 0a 6d 61 79 | channel|s it.may|
|00000860| 20 62 65 20 63 61 6c 6c | 65 64 20 73 75 62 73 65 | be call|ed subse|
|00000870| 71 75 65 6e 74 6c 79 20 | 74 6f 20 72 65 69 6e 69 |quently |to reini|
|00000880| 74 69 61 6c 69 73 65 20 | 74 68 65 20 63 68 61 6e |tialise |the chan|
|00000890| 6e 65 6c 20 74 6f 20 61 | 20 64 69 66 66 65 72 65 |nel to a| differe|
|000008a0| 6e 74 0a 6d 6f 64 65 20 | 6f 66 20 6f 70 65 72 61 |nt.mode |of opera|
|000008b0| 74 69 6f 6e 2e 0a 0a 3c | 50 3e 0a 54 68 65 20 70 |tion...<|P>.The p|
|000008c0| 72 6f 63 65 73 73 20 66 | 75 6e 63 74 69 6f 6e 20 |rocess f|unction |
|000008d0| 69 73 20 74 68 65 20 6f | 6e 65 20 74 68 61 74 20 |is the o|ne that |
|000008e0| 64 6f 65 73 20 74 68 65 | 20 72 65 61 6c 20 77 6f |does the| real wo|
|000008f0| 72 6b 20 6f 66 20 74 68 | 65 0a 63 68 61 6e 6e 65 |rk of th|e.channe|
|00000900| 6c 2e 20 49 74 20 73 68 | 6f 75 6c 64 20 62 65 20 |l. It sh|ould be |
|00000910| 64 65 66 69 6e 65 64 20 | 6c 69 6b 65 20 74 68 69 |defined |like thi|
|00000920| 73 3a 3c 50 52 45 3e 0a | 73 74 72 75 63 74 20 74 |s:<PRE>.|struct t|
|00000930| 79 70 65 5f 51 6d 67 72 | 5f 44 65 6c 69 76 65 72 |ype_Qmgr|_Deliver|
|00000940| 79 53 74 61 74 75 73 20 | 2a 70 72 6f 63 65 73 73 |yStatus |*process|
|00000950| 6d 65 73 73 61 67 65 20 | 28 61 72 67 29 0a 73 74 |message |(arg).st|
|00000960| 72 75 63 74 20 74 79 70 | 65 5f 51 6d 67 72 5f 50 |ruct typ|e_Qmgr_P|
|00000970| 72 6f 63 4d 73 67 20 2a | 61 72 67 3b 0a 3c 2f 50 |rocMsg *|arg;.</P|
|00000980| 52 45 3e 0a 54 68 65 20 | 66 75 6e 63 74 69 6f 6e |RE>.The |function|
|00000990| 20 73 68 6f 75 6c 64 20 | 74 68 65 6e 20 61 74 74 | should |then att|
|000009a0| 65 6d 70 74 20 74 6f 20 | 70 72 6f 63 65 73 73 20 |empt to |process |
|000009b0| 74 68 65 20 67 69 76 65 | 6e 20 6d 65 73 73 61 67 |the give|n messag|
|000009c0| 65 20 66 6f 72 20 74 68 | 65 0a 67 69 76 65 6e 20 |e for th|e.given |
|000009d0| 72 65 63 69 70 69 65 6e | 74 73 2e 20 54 68 69 73 |recipien|ts. This|
|000009e0| 20 75 73 75 61 6c 6c 79 | 20 69 6e 76 6f 6c 76 65 | usually| involve|
|000009f0| 73 20 66 69 72 73 74 20 | 72 65 61 64 69 6e 67 20 |s first |reading |
|00000a00| 74 68 65 20 61 64 64 72 | 65 73 73 0a 63 6f 6e 74 |the addr|ess.cont|
|00000a10| 72 6f 6c 20 66 69 6c 65 | 20 67 69 76 65 6e 20 61 |rol file| given a|
|00000a20| 73 20 70 61 72 74 20 6f | 66 20 74 68 65 20 73 74 |s part o|f the st|
|00000a30| 72 75 63 74 75 72 65 20 | 70 61 73 73 65 64 2e 0a |ructure |passed..|
|00000a40| 0a 3c 50 3e 0a 57 68 65 | 6e 20 74 68 65 20 70 72 |.<P>.Whe|n the pr|
|00000a50| 6f 63 65 73 73 69 6e 67 | 20 6f 66 20 74 68 65 20 |ocessing| of the |
|00000a60| 6d 65 73 73 61 67 65 20 | 68 61 73 20 66 69 6e 69 |message |has fini|
|00000a70| 73 68 65 64 2c 20 74 68 | 65 20 66 75 6e 63 74 69 |shed, th|e functi|
|00000a80| 6f 6e 20 73 68 6f 75 6c | 64 0a 72 65 74 75 72 6e |on shoul|d.return|
|00000a90| 20 61 20 70 6f 69 6e 74 | 65 72 20 74 6f 20 61 20 | a point|er to a |
|00000aa0| 6c 69 73 74 20 6f 66 20 | 72 65 63 69 70 69 65 6e |list of |recipien|
|00000ab0| 74 20 6e 75 6d 62 65 72 | 73 20 74 6f 67 65 74 68 |t number|s togeth|
|00000ac0| 65 72 20 77 69 74 68 20 | 61 20 73 74 61 74 75 73 |er with |a status|
|00000ad0| 0a 66 69 65 6c 64 2e 20 | 54 68 69 73 20 73 74 72 |.field. |This str|
|00000ae0| 75 63 74 75 72 65 20 69 | 73 20 74 68 65 20 3c 63 |ucture i|s the <c|
|00000af0| 6f 64 65 3e 74 79 70 65 | 5f 51 6d 67 72 5f 44 65 |ode>type|_Qmgr_De|
|00000b00| 6c 69 76 65 72 79 53 74 | 61 74 75 73 3c 2f 63 6f |liverySt|atus</co|
|00000b10| 64 65 3e 0a 73 74 72 75 | 63 74 75 72 65 2e 20 54 |de>.stru|cture. T|
|00000b20| 68 69 73 20 73 70 65 63 | 69 66 69 65 73 20 66 6f |his spec|ifies fo|
|00000b30| 72 20 65 61 63 68 20 72 | 65 63 69 70 69 65 6e 74 |r each r|ecipient|
|00000b40| 20 77 68 65 74 68 65 72 | 20 74 68 65 20 6f 70 65 | whether| the ope|
|00000b50| 72 61 74 69 6f 6e 20 77 | 61 73 0a 61 20 73 75 63 |ration w|as.a suc|
|00000b60| 63 65 73 73 20 6f 72 20 | 66 61 69 6c 75 72 65 2e |cess or |failure.|
|00000b70| 20 54 68 65 20 73 74 61 | 74 75 73 20 76 61 6c 75 | The sta|tus valu|
|00000b80| 65 73 20 61 72 65 3a 0a | 3c 42 52 3e 0a 3c 49 4d |es are:.|<BR>.<IM|
|00000b90| 47 0a 20 20 53 54 59 4c | 45 3d 22 22 20 53 52 43 |G.  STYL|E="" SRC|
|00000ba0| 3d 22 69 6d 67 32 2e 70 | 6e 67 22 0a 20 41 4c 54 |="img2.p|ng". ALT|
|00000bb0| 3d 22 5c 62 65 67 69 6e | 7b 64 65 73 63 72 69 62 |="\begin|{describ|
|00000bc0| 65 7d 0a 5c 69 74 65 6d | 5b 5c 76 65 72 62 5c 76 |e}.\item|[\verb\v|
|00000bd0| 65 72 74 20 69 6e 74 5c | 5f 51 6d 67 72 5c 5f 73 |ert int\|_Qmgr\_s|
|00000be0| 74 61 74 75 73 5c 5f 73 | 75 63 63 65 73 73 5c 76 |tatus\_s|uccess\v|
|00000bf0| 65 72 74 3a 5d 5c 69 6e | 64 65 78 7b 73 74 61 74 |ert:]\in|dex{stat|
|00000c00| 75 73 2e 2e 2e 0a 2e 2e | 2e 65 20 4d 54 41 2e 20 |us......|.e MTA. |
|00000c10| 54 68 69 73 20 63 68 61 | 6e 6e 65 6c 20 73 68 6f |This cha|nnel sho|
|00000c20| 75 6c 64 20 62 65 20 61 | 74 74 65 6d 70 74 65 64 |uld be a|ttempted|
|00000c30| 20 61 67 61 69 6e 20 69 | 6e 20 74 68 65 20 6e 65 | again i|n the ne|
|00000c40| 61 72 0a 66 75 74 75 72 | 65 2e 0a 5c 65 6e 64 7b |ar.futur|e..\end{|
|00000c50| 64 65 73 63 72 69 62 65 | 7d 22 3e 0a 3c 42 52 3e |describe|}">.<BR>|
|00000c60| 0a 0a 3c 50 3e 0a 54 6f | 20 61 69 64 20 69 6e 20 |..<P>.To| aid in |
|00000c70| 73 65 74 74 69 6e 67 20 | 74 68 65 73 65 20 76 61 |setting |these va|
|00000c80| 6c 75 65 73 2c 20 61 20 | 73 65 74 20 6f 66 20 73 |lues, a |set of s|
|00000c90| 75 70 70 6f 72 74 20 72 | 6f 75 74 69 6e 65 73 20 |upport r|outines |
|00000ca0| 69 73 20 70 72 6f 76 69 | 64 65 64 0a 69 6e 20 74 |is provi|ded.in t|
|00000cb0| 68 65 20 6c 69 62 72 61 | 72 79 2e 20 54 68 65 73 |he libra|ry. Thes|
|00000cc0| 65 20 72 6f 75 74 69 6e | 65 73 20 61 6c 6c 20 75 |e routin|es all u|
|00000cd0| 70 64 61 74 65 20 74 68 | 65 20 67 6c 6f 62 61 6c |pdate th|e global|
|00000ce0| 20 76 61 72 69 61 62 6c | 65 0a 3c 63 6f 64 65 3e | variabl|e.<code>|
|00000cf0| 64 65 6c 69 76 65 72 79 | 73 74 61 74 65 3c 2f 63 |delivery|state</c|
|00000d00| 6f 64 65 3e 20 77 68 69 | 63 68 20 69 73 20 73 75 |ode> whi|ch is su|
|00000d10| 69 74 61 62 6c 65 20 61 | 73 20 61 20 72 65 74 75 |itable a|s a retu|
|00000d20| 72 6e 20 76 61 6c 75 65 | 20 66 6f 72 20 74 68 65 |rn value| for the|
|00000d30| 0a 70 72 6f 63 65 73 73 | 20 66 75 6e 63 74 69 6f |.process| functio|
|00000d40| 6e 2e 20 4e 6f 74 65 2c | 20 68 6f 77 65 76 65 72 |n. Note,| however|
|00000d50| 2c 20 74 68 61 74 20 74 | 68 65 20 76 61 6c 75 65 |, that t|he value|
|00000d60| 20 6f 66 0a 3c 63 6f 64 | 65 3e 69 6e 74 5f 51 6d | of.<cod|e>int_Qm|
|00000d70| 67 72 5f 73 74 61 74 75 | 73 5f 70 65 72 6d 61 6e |gr_statu|s_perman|
|00000d80| 65 6e 74 46 61 69 6c 75 | 72 65 3c 2f 63 6f 64 65 |entFailu|re</code|
|00000d90| 3e 20 69 73 20 60 60 73 | 74 69 63 6b 79 27 27 3b |> is ``s|ticky'';|
|00000da0| 20 74 68 69 73 20 76 61 | 6c 75 65 20 6d 61 79 0a | this va|lue may.|
|00000db0| 62 65 20 73 65 74 2c 20 | 62 75 74 20 6f 6e 63 65 |be set, |but once|
|00000dc0| 20 73 65 74 20 63 61 6e | 6e 6f 74 20 62 65 20 6f | set can|not be o|
|00000dd0| 76 65 72 77 72 69 74 74 | 65 6e 20 62 79 20 74 68 |verwritt|en by th|
|00000de0| 65 73 65 20 72 6f 75 74 | 69 6e 65 73 2e 20 54 68 |ese rout|ines. Th|
|00000df0| 69 73 20 69 73 0a 62 65 | 63 61 75 73 65 20 6e 6f |is is.be|cause no|
|00000e00| 72 6d 61 6c 6c 79 20 77 | 68 65 6e 20 61 6e 20 61 |rmally w|hen an a|
|00000e10| 64 64 72 65 73 73 20 69 | 73 20 6d 61 72 6b 65 64 |ddress i|s marked|
|00000e20| 20 77 69 74 68 20 74 68 | 69 73 20 73 74 61 74 75 | with th|is statu|
|00000e30| 73 2c 20 61 0a 64 65 6c | 69 76 65 72 79 20 72 65 |s, a.del|ivery re|
|00000e40| 70 6f 72 74 20 69 73 20 | 77 72 69 74 74 65 6e 20 |port is |written |
|00000e50| 6f 75 74 20 61 6e 64 20 | 74 68 65 20 6d 65 73 73 |out and |the mess|
|00000e60| 61 67 65 20 69 73 20 75 | 70 64 61 74 65 64 20 61 |age is u|pdated a|
|00000e70| 63 63 6f 72 64 69 6e 67 | 6c 79 0a 28 73 65 65 20 |ccording|ly.(see |
|00000e80| 53 65 63 74 69 6f 6e 26 | 6e 62 73 70 3b 3c 41 20 |Section&|nbsp;<A |
|00000e90| 48 52 45 46 3d 22 6e 6f | 64 65 39 5f 63 74 2e 68 |HREF="no|de9_ct.h|
|00000ea0| 74 6d 6c 23 73 65 74 3a | 64 72 22 3e 33 2e 32 2e |tml#set:|dr">3.2.|
|00000eb0| 33 3c 2f 41 3e 20 66 6f | 72 20 72 6f 75 74 69 6e |3</A> fo|r routin|
|00000ec0| 65 73 20 74 6f 20 77 72 | 69 74 65 20 6f 75 74 20 |es to wr|ite out |
|00000ed0| 64 65 6c 69 76 65 72 79 | 20 72 65 70 6f 72 74 73 |delivery| reports|
|00000ee0| 29 2e 0a 54 6f 20 20 73 | 65 74 20 74 68 65 20 73 |)..To  s|et the s|
|00000ef0| 74 61 74 75 73 20 20 74 | 68 65 6e 20 74 6f 20 73 |tatus  t|hen to s|
|00000f00| 6f 6d 65 74 68 69 6e 67 | 20 65 6c 73 65 20 77 6f |omething| else wo|
|00000f10| 75 6c 64 20 63 6f 6e 66 | 75 73 65 20 74 68 65 20 |uld conf|use the |
|00000f20| 71 75 65 75 65 0a 6d 61 | 6e 61 67 65 72 2e 20 54 |queue.ma|nager. T|
|00000f30| 68 65 20 72 6f 75 74 69 | 6e 65 73 20 61 72 65 20 |he routi|nes are |
|00000f40| 61 73 20 66 6f 6c 6c 6f | 77 73 3a 0a 0a 3c 50 3e |as follo|ws:..<P>|
|00000f50| 0a 3c 42 4c 4f 43 4b 51 | 55 4f 54 45 3e 0a 3c 41 |.<BLOCKQ|UOTE>.<A|
|00000f60| 20 49 44 3d 22 35 35 22 | 3e 3c 2f 41 3e 3c 2f 42 | ID="55"|></A></B|
|00000f70| 4c 4f 43 4b 51 55 4f 54 | 45 3e 3c 50 52 45 3e 0a |LOCKQUOT|E><PRE>.|
|00000f80| 73 74 72 75 63 74 20 74 | 79 70 65 5f 51 6d 67 72 |struct t|ype_Qmgr|
|00000f90| 5f 44 65 6c 69 76 65 72 | 79 53 74 61 74 75 73 20 |_Deliver|yStatus |
|00000fa0| 2a 64 65 6c 69 76 65 72 | 79 5f 69 6e 69 74 20 28 |*deliver|y_init (|
|00000fb0| 75 73 65 72 73 29 0a 73 | 74 72 75 63 74 20 74 79 |users).s|truct ty|
|00000fc0| 70 65 5f 51 6d 67 72 5f | 55 73 65 72 4c 69 73 74 |pe_Qmgr_|UserList|
|00000fd0| 20 2a 75 73 65 72 73 3b | 0a 3c 2f 50 52 45 3e 0a | *users;|.</PRE>.|
|00000fe0| 0a 3c 50 3e 0a 54 68 69 | 73 20 72 6f 75 74 69 6e |.<P>.Thi|s routin|
|00000ff0| 65 20 69 6e 69 74 69 61 | 6c 69 73 65 73 20 74 68 |e initia|lises th|
|00001000| 65 20 73 74 72 75 63 74 | 75 72 65 2e 20 49 74 20 |e struct|ure. It |
|00001010| 64 6f 65 73 20 62 79 20 | 61 6c 6c 6f 63 61 74 69 |does by |allocati|
|00001020| 6e 67 20 61 6e 0a 65 6c | 65 6d 65 6e 74 20 66 6f |ng an.el|ement fo|
|00001030| 72 20 65 61 63 68 20 6f | 66 20 74 68 65 20 75 73 |r each o|f the us|
|00001040| 65 72 73 20 70 61 73 73 | 65 64 20 69 6e 20 74 68 |ers pass|ed in th|
|00001050| 65 20 61 72 67 75 6d 65 | 6e 74 2e 20 54 68 65 20 |e argume|nt. The |
|00001060| 73 69 6e 67 6c 65 0a 70 | 61 72 61 6d 65 74 65 72 |single.p|arameter|
|00001070| 20 69 73 20 74 68 65 20 | 6c 69 73 74 20 6f 66 20 | is the |list of |
|00001080| 75 73 65 72 73 20 70 61 | 73 73 65 64 20 6f 76 65 |users pa|ssed ove|
|00001090| 72 20 62 79 20 74 68 65 | 20 51 4d 47 52 2e 0a 0a |r by the| QMGR...|
|000010a0| 3c 50 3e 0a 3c 42 4c 4f | 43 4b 51 55 4f 54 45 3e |<P>.<BLO|CKQUOTE>|
|000010b0| 0a 3c 41 20 49 44 3d 22 | 36 30 22 3e 3c 2f 41 3e |.<A ID="|60"></A>|
|000010c0| 3c 2f 42 4c 4f 43 4b 51 | 55 4f 54 45 3e 3c 50 52 |</BLOCKQ|UOTE><PR|
|000010d0| 45 3e 0a 73 74 72 75 63 | 74 20 74 79 70 65 5f 51 |E>.struc|t type_Q|
|000010e0| 6d 67 72 5f 44 65 6c 69 | 76 65 72 79 53 74 61 74 |mgr_Deli|veryStat|
|000010f0| 75 73 20 0a 20 20 20 20 | 20 20 20 2a 64 65 6c 69 |us .    |   *deli|
|00001100| 76 65 72 79 5f 73 65 74 | 73 74 61 74 65 20 28 72 |very_set|state (r|
|00001110| 6e 6f 2c 20 76 61 6c 2c | 20 72 65 61 73 6f 6e 29 |no, val,| reason)|
|00001120| 0a 69 6e 74 20 20 72 6e | 6f 2c 20 76 61 6c 3b 0a |.int  rn|o, val;.|
|00001130| 63 68 61 72 20 2a 72 65 | 61 73 6f 6e 3b 0a 3c 2f |char *re|ason;.</|
|00001140| 50 52 45 3e 0a 0a 3c 50 | 3e 0a 54 68 69 73 20 72 |PRE>..<P|>.This r|
|00001150| 6f 75 74 69 6e 65 20 73 | 65 74 73 20 74 68 65 20 |outine s|ets the |
|00001160| 76 61 6c 75 65 20 6f 66 | 20 74 68 65 20 67 69 76 |value of| the giv|
|00001170| 65 6e 20 72 65 63 69 70 | 69 65 6e 74 20 6e 75 6d |en recip|ient num|
|00001180| 62 65 72 20 74 6f 20 74 | 68 65 0a 69 6e 64 69 63 |ber to t|he.indic|
|00001190| 61 74 65 64 20 76 61 6c | 75 65 20 69 6e 20 74 68 |ated val|ue in th|
|000011a0| 65 20 67 6c 6f 62 61 6c | 20 73 74 72 75 63 74 75 |e global| structu|
|000011b0| 72 65 20 28 77 69 74 68 | 20 74 68 65 20 61 62 6f |re (with| the abo|
|000011c0| 76 65 20 70 72 6f 76 69 | 73 6f 29 2e 20 49 74 0a |ve provi|so). It.|
|000011d0| 61 6c 73 6f 20 69 6e 63 | 6c 75 64 65 73 20 61 20 |also inc|ludes a |
|000011e0| 73 74 72 69 6e 67 20 69 | 6e 64 69 63 61 74 69 6e |string i|ndicatin|
|000011f0| 67 20 74 68 65 20 72 65 | 61 73 6f 6e 20 66 6f 72 |g the re|ason for|
|00001200| 20 66 61 69 6c 75 72 65 | 2c 20 69 66 20 66 61 69 | failure|, if fai|
|00001210| 6c 75 72 65 0a 6f 63 63 | 75 72 72 65 64 2e 20 54 |lure.occ|urred. T|
|00001220| 68 69 73 20 73 74 72 69 | 6e 67 20 69 73 20 70 61 |his stri|ng is pa|
|00001230| 73 73 65 64 20 62 61 63 | 6b 20 74 6f 20 74 68 65 |ssed bac|k to the|
|00001240| 20 51 4d 47 52 20 66 6f | 72 20 64 69 73 70 6c 61 | QMGR fo|r displa|
|00001250| 79 20 62 79 0a 74 68 65 | 20 4d 54 41 63 6f 6e 73 |y by.the| MTAcons|
|00001260| 6f 6c 65 2e 20 49 74 20 | 73 68 6f 75 6c 64 20 62 |ole. It |should b|
|00001270| 65 20 73 65 74 20 74 6f | 20 74 68 65 20 63 6f 6e |e set to| the con|
|00001280| 73 74 61 6e 74 20 3c 63 | 6f 64 65 3e 4e 55 4c 4c |stant <c|ode>NULL|
|00001290| 43 50 3c 2f 63 6f 64 65 | 3e 0a 69 66 20 74 68 65 |CP</code|>.if the|
|000012a0| 20 72 65 63 69 70 69 65 | 6e 74 20 77 61 73 20 68 | recipie|nt was h|
|000012b0| 61 6e 64 6c 65 64 20 73 | 75 63 63 65 73 73 66 75 |andled s|uccessfu|
|000012c0| 6c 6c 79 20 6f 72 20 6e | 6f 20 64 69 61 67 6e 6f |lly or n|o diagno|
|000012d0| 73 74 69 63 20 72 65 61 | 73 6f 6e 20 69 73 20 61 |stic rea|son is a|
|000012e0| 76 61 69 6c 61 62 6c 65 | 2e 0a 0a 3c 50 3e 0a 3c |vailable|...<P>.<|
|000012f0| 42 4c 4f 43 4b 51 55 4f | 54 45 3e 0a 3c 41 20 49 |BLOCKQUO|TE>.<A I|
|00001300| 44 3d 22 36 35 22 3e 3c | 2f 41 3e 3c 2f 42 4c 4f |D="65"><|/A></BLO|
|00001310| 43 4b 51 55 4f 54 45 3e | 3c 50 52 45 3e 0a 73 74 |CKQUOTE>|<PRE>.st|
|00001320| 72 75 63 74 20 74 79 70 | 65 5f 51 6d 67 72 5f 44 |ruct typ|e_Qmgr_D|
|00001330| 65 6c 69 76 65 72 79 53 | 74 61 74 75 73 20 0a 20 |eliveryS|tatus . |
|00001340| 20 20 20 20 20 20 2a 64 | 65 6c 69 76 65 72 79 5f |      *d|elivery_|
|00001350| 73 65 74 61 6c 6c 73 74 | 61 74 65 20 28 76 61 6c |setallst|ate (val|
|00001360| 2c 20 72 65 61 73 6f 6e | 29 0a 69 6e 74 20 20 76 |, reason|).int  v|
|00001370| 61 6c 3b 0a 63 68 61 72 | 20 2a 72 65 61 73 6f 6e |al;.char| *reason|
|00001380| 3b 0a 3c 2f 50 52 45 3e | 0a 0a 3c 50 3e 0a 54 68 |;.</PRE>|..<P>.Th|
|00001390| 69 73 20 72 6f 75 74 69 | 6e 65 20 73 65 74 73 20 |is routi|ne sets |
|000013a0| 61 6c 6c 20 75 73 65 72 | 73 27 20 73 74 61 74 75 |all user|s' statu|
|000013b0| 73 20 74 6f 20 74 68 65 | 20 67 69 76 65 6e 20 76 |s to the| given v|
|000013c0| 61 6c 75 65 2e 20 54 68 | 69 73 20 69 73 20 75 73 |alue. Th|is is us|
|000013d0| 65 66 75 6c 0a 77 68 65 | 6e 20 61 20 63 6f 6e 6e |eful.whe|n a conn|
|000013e0| 65 63 74 69 6f 6e 20 63 | 61 6e 6e 6f 74 20 62 65 |ection c|annot be|
|000013f0| 20 65 73 74 61 62 6c 69 | 73 68 65 64 2c 20 66 6f | establi|shed, fo|
|00001400| 72 20 69 6e 73 74 61 6e | 63 65 2c 20 61 6e 64 20 |r instan|ce, and |
|00001410| 61 6c 6c 20 72 65 63 69 | 70 69 65 6e 74 73 0a 6d |all reci|pients.m|
|00001420| 75 73 74 20 62 65 20 70 | 75 74 20 69 6e 20 74 68 |ust be p|ut in th|
|00001430| 65 20 73 61 6d 65 20 73 | 74 61 74 65 20 28 61 67 |e same s|tate (ag|
|00001440| 61 69 6e 2c 20 74 68 65 | 20 61 62 6f 76 65 20 70 |ain, the| above p|
|00001450| 72 6f 76 69 73 6f 20 61 | 62 6f 75 74 20 64 65 6c |roviso a|bout del|
|00001460| 69 76 65 72 79 0a 72 65 | 70 6f 72 74 73 20 68 6f |ivery.re|ports ho|
|00001470| 6c 64 73 29 2e 20 54 68 | 65 20 72 65 61 73 6f 6e |lds). Th|e reason|
|00001480| 20 66 69 65 6c 64 20 69 | 73 20 74 68 65 20 73 61 | field i|s the sa|
|00001490| 6d 65 20 61 73 20 61 62 | 6f 76 65 2e 0a 0a 3c 50 |me as ab|ove...<P|
|000014a0| 3e 0a 4f 63 63 61 73 69 | 6f 6e 61 6c 6c 79 20 69 |>.Occasi|onally i|
|000014b0| 74 20 6d 61 79 20 6f 63 | 63 75 72 20 74 68 61 74 |t may oc|cur that|
|000014c0| 20 61 20 70 65 72 6d 61 | 6e 65 6e 74 20 66 61 69 | a perma|nent fai|
|000014d0| 6c 75 72 65 20 69 73 20 | 72 65 63 65 69 76 65 64 |lure is |received|
|000014e0| 20 62 75 74 20 69 74 0a | 69 73 20 6e 6f 74 20 70 | but it.|is not p|
|000014f0| 6f 73 73 69 62 6c 65 20 | 74 6f 20 77 72 69 74 65 |ossible |to write|
|00001500| 20 61 20 64 65 6c 69 76 | 65 72 79 20 72 65 70 6f | a deliv|ery repo|
|00001510| 72 74 20 28 65 2e 67 2e | 2c 20 61 20 66 75 6c 6c |rt (e.g.|, a full|
|00001520| 20 64 69 73 6b 29 2e 20 | 49 6e 20 74 68 69 73 0a | disk). |In this.|
|00001530| 63 61 73 65 20 74 68 65 | 20 61 64 64 72 65 73 73 |case the| address|
|00001540| 20 66 69 6c 65 20 73 68 | 6f 75 6c 64 20 6e 6f 74 | file sh|ould not|
|00001550| 20 62 65 20 75 70 64 61 | 74 65 64 20 61 6e 64 20 | be upda|ted and |
|00001560| 74 68 65 20 44 52 20 73 | 74 61 74 75 73 20 73 68 |the DR s|tatus sh|
|00001570| 6f 75 6c 64 0a 62 65 20 | 73 65 74 20 74 6f 20 6d |ould.be |set to m|
|00001580| 65 73 73 61 67 65 20 66 | 61 69 6c 75 72 65 20 28 |essage f|ailure (|
|00001590| 74 68 65 20 6e 65 78 74 | 20 72 65 74 72 79 20 73 |the next| retry s|
|000015a0| 68 6f 75 6c 64 20 61 6c | 73 6f 20 67 69 76 65 20 |hould al|so give |
|000015b0| 61 20 44 52 20 61 6e 64 | 0a 74 68 65 6e 20 68 6f |a DR and|.then ho|
|000015c0| 70 65 66 75 6c 6c 79 20 | 61 20 72 65 70 6f 72 74 |pefully |a report|
|000015d0| 20 63 61 6e 20 62 65 20 | 77 72 69 74 74 65 6e 29 | can be |written)|
|000015e0| 2e 20 54 6f 20 61 69 64 | 20 69 6e 20 72 65 73 65 |. To aid| in rese|
|000015f0| 74 74 69 6e 67 20 74 68 | 65 73 65 0a 76 61 72 69 |tting th|ese.vari|
|00001600| 61 62 6c 65 73 20 74 68 | 65 20 66 6f 6c 6c 6f 77 |ables th|e follow|
|00001610| 69 6e 67 20 70 72 6f 63 | 65 64 75 72 65 20 69 73 |ing proc|edure is|
|00001620| 20 75 73 65 66 75 6c 2e | 0a 0a 3c 50 3e 0a 3c 42 | useful.|..<P>.<B|
|00001630| 4c 4f 43 4b 51 55 4f 54 | 45 3e 0a 3c 41 20 49 44 |LOCKQUOT|E>.<A ID|
|00001640| 3d 22 37 30 22 3e 3c 2f | 41 3e 3c 2f 42 4c 4f 43 |="70"></|A></BLOC|
|00001650| 4b 51 55 4f 54 45 3e 3c | 50 52 45 3e 0a 73 74 72 |KQUOTE><|PRE>.str|
|00001660| 75 63 74 20 74 79 70 65 | 5f 51 6d 67 72 5f 44 65 |uct type|_Qmgr_De|
|00001670| 6c 69 76 65 72 79 53 74 | 61 74 75 73 0a 20 20 20 |liverySt|atus.   |
|00001680| 20 20 20 20 2a 64 65 6c | 69 76 65 72 79 5f 72 65 |    *del|ivery_re|
|00001690| 73 65 74 44 52 73 20 28 | 76 61 6c 29 0a 69 6e 74 |setDRs (|val).int|
|000016a0| 20 20 20 20 20 76 61 6c | 3b 0a 3c 2f 50 52 45 3e |     val|;.</PRE>|
|000016b0| 0a 0a 3c 50 3e 0a 54 68 | 65 20 61 72 67 75 6d 65 |..<P>.Th|e argume|
|000016c0| 6e 74 20 69 73 20 74 68 | 65 20 73 74 61 74 65 20 |nt is th|e state |
|000016d0| 74 6f 20 73 65 74 20 74 | 68 65 20 44 52 20 76 61 |to set t|he DR va|
|000016e0| 6c 75 65 73 20 74 6f 20 | 28 6e 65 61 72 6c 79 20 |lues to |(nearly |
|000016f0| 61 6c 77 61 79 73 0a 3c | 42 52 3e 3c 63 6f 64 65 |always.<|BR><code|
|00001700| 3e 69 6e 74 5f 51 6d 67 | 72 5f 53 74 61 74 75 73 |>int_Qmg|r_Status|
|00001710| 5f 6d 65 73 73 61 67 65 | 46 61 69 6c 75 72 65 3c |_message|Failure<|
|00001720| 2f 63 6f 64 65 3e 29 2e | 0a 0a 3c 50 3e 0a 54 68 |/code>).|..<P>.Th|
|00001730| 65 20 74 65 72 6d 69 6e | 61 74 69 6f 6e 20 66 75 |e termin|ation fu|
|00001740| 6e 63 74 69 6f 6e 2c 20 | 69 66 20 75 73 65 64 2c |nction, |if used,|
|00001750| 20 73 68 6f 75 6c 64 20 | 62 65 20 64 65 66 69 6e | should |be defin|
|00001760| 65 64 20 61 73 20 66 6f | 6c 6c 6f 77 73 2e 3c 50 |ed as fo|llows.<P|
|00001770| 52 45 3e 0a 69 6e 74 20 | 65 6e 64 66 75 63 74 69 |RE>.int |endfucti|
|00001780| 6f 6e 20 28 29 0a 3c 2f | 50 52 45 3e 0a 0a 3c 50 |on ().</|PRE>..<P|
|00001790| 3e 0a 54 68 69 73 20 72 | 6f 75 74 69 6e 65 20 69 |>.This r|outine i|
|000017a0| 73 20 75 73 65 64 20 74 | 6f 20 63 6c 6f 73 65 20 |s used t|o close |
|000017b0| 64 6f 77 6e 20 61 6e 79 | 74 68 69 6e 67 20 72 65 |down any|thing re|
|000017c0| 71 75 69 72 65 64 20 62 | 65 66 6f 72 65 20 65 78 |quired b|efore ex|
|000017d0| 69 74 69 6e 67 0a 74 68 | 65 20 70 72 6f 67 72 61 |iting.th|e progra|
|000017e0| 6d 2e 20 54 68 65 20 63 | 61 6c 6c 69 6e 67 20 72 |m. The c|alling r|
|000017f0| 6f 75 74 69 6e 65 20 77 | 69 6c 6c 20 65 78 65 63 |outine w|ill exec|
|00001800| 75 74 65 20 74 68 69 73 | 20 66 75 6e 63 74 69 6f |ute this| functio|
|00001810| 6e 20 62 65 66 6f 72 65 | 20 73 65 6e 64 69 6e 67 |n before| sending|
|00001820| 0a 74 68 65 20 66 69 6e | 61 6c 20 64 69 73 63 6f |.the fin|al disco|
|00001830| 6e 6e 65 63 74 20 74 6f | 20 74 68 65 20 51 4d 47 |nnect to| the QMG|
|00001840| 52 20 61 6e 64 20 65 78 | 69 74 69 6e 67 2e 0a 0a |R and ex|iting...|
|00001850| 3c 50 3e 0a 0a 3c 48 52 | 3e 0a 0a 3c 2f 42 4f 44 |<P>..<HR|>..</BOD|
|00001860| 59 3e 0a 3c 2f 48 54 4d | 4c 3e 0a                |Y>.</HTM|L>.     |
+--------+-------------------------+-------------------------+--------+--------+